Markdown基础语法

发表于 | 更新于: | 分类于

GO

本文转自献给写作者的 Markdown 新手指南

1. Markdown 的优点：

  • 纯文本，所以兼容性极强，可以用所有文本编辑器打开。
  • 让你专注于文字而不是排版。
  • 格式转换方便，Markdown 的文本你可以轻松转换为 html、电子书等。
  • Markdown 的标记语法有极好的可读性。

2. Markdown 的基础语法：

2.1 标题

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

注意：“#”和[标题]之间建议保留一个字符的空格，这是标准的Markdown写法。

2.2 列表

2.2.1 无序列表

只需要在文字前面加上 - 就可以了。例如：

1
2
3
- 文本1
- 文本2
- 文本3

2.2.2 有序列表

1
2
3
1. 文本1
2. 文本2
3. 文本3

注意：“-”、“>”与文本之间保留一个字符的空格。

2.3 链接和图片

2.3.1 插入链接的语法：

[显示文本](链接地址)

一个例子：[简书](http://www.jianshu.com)

2.3.2 插入图片的语法：

![](图片链接地址)

一个例子：![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

注意：插入图片的语法和链接的语法很像，只是前面多了一个 ！

2.4 引用

在我们写作的时候经常需要引用他人的文字，这个时候引用这个格式就很有必要了。

在 Markdown 中，你只需要在你希望引用的文字前面加上 > 就好了，例如：

1
> 一盏灯， 一片昏黄； 一简书， 一杯淡茶。

注：”>” 和文本之间要保留一个字符的空格。

2.5 粗体和斜体

用两个 * 包含一段文本就是粗体的语法，用一个 * 包含一段文本就是斜体的语法。例如：

1
*一盏灯*， 一片昏黄；**一简书**， 一杯淡茶。

其中「一盏灯」是斜体，「一简书」是粗体。

2.6 代码引用

需要引用代码时，如果引用的语句只有一段，不分行，可以用 ` 将语句包起来。
如果引用的语句为多行，可以将三个连续的`置于这段代码的首行和末行。

2.7 表格

相关代码：

1
2
3
4
5
| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

显示效果：

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

相关代码：

1
2
3
4
5
dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

显示效果：

dog bird cat
foo foo foo
bar bar bar
baz baz baz

2.8 显示链接中带括号的图片

代码如下：

1
2
![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1

注意：像括号这种特殊符号需要用“\”转义。

3. 结束语

Markdown的基础语法就是这么多了，对于一个写作者来说，这些就完全够用了。

如果想要学习更多Markdown的用法，参考这一篇文章：『Markdown 语法说明』

OK

0%